home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 21 / q21.d81 / t.docs 4 < prev    next >
Text File  |  2022-08-28  |  14KB  |  270 lines
  1.  
  2.  
  3. * * * THE AUTOBOOT TOOL * * *
  4.  
  5. The boot sector is a feature which is supposed to launch software off the
  6. disk as soon as the computer is powered up or reset.  However, using this
  7. handy feature for your own purposes has been very difficult.  The autoboot
  8. tool consists of several modules which makes creation and manipulation of
  9. boot sectors quick and easy.  Also, using DISKSERVANT, a boot sector may be
  10. created to be used on a disk drive of any device number.
  11.  
  12. SPECIAL NOTE to 1581 users:  Using the Autoboot Tool, the root directory
  13. will be automatically selected.  A boot sector cannot exist under a
  14. subdirectory.
  15.  
  16. ANALYZE BOOT SECTOR:
  17. This feature will decode the boot sector and display its results on the
  18. screen.  First, it indicates if a boot sector is present, if the boot sector
  19. is occupied by a file, or if a "killed" boot sector is present.  Also,
  20. you'll be warned if it is not protected from overwriting (not protected by
  21. BAM).  In that case use the Protect Sector(s) feature to protect it if
  22. desired.  If a boot sector exists, the following information is provided:
  23.  
  24. 1) Additional boot sectors info.  The C128 boot system has an option to read
  25. additional blocks off the disk as part of the boot area.  These extra
  26. sectors starts at track 1, sector 1, and continue onward from there.  It is
  27. possible to place these extra blocks anywhere in the computer's memory.  How
  28. many extra blocks to be loaded, the address and memory bank where they are
  29. placed is displayed.
  30.  
  31. 2) Load PRG file:  A file name can be specified in the boot sector, and if
  32. present, a PRG file of that name is loaded into bank 0 RAM.  The load
  33. address is determined by the load address of the program itself.  The file
  34. name (if any) will be displayed along with the load address.  The load
  35. address must be sought in the file itself, and if the file can't be read, a
  36. DOS error message is displayed instead of the load address.
  37.  
  38. 3) ML code start:  The boot sector must contain some ML code to determine
  39. what the boot sector is supposed to do.  It may be a simple JMP instruction
  40. (similar to BASIC SYS), or an elaborate ML program.  The start address of
  41. the ML code is not fixed; it is determined by the length of the boot message
  42. (see below) and file name (above).  The start address is displayed as an
  43. offset from the start of the boot buffer in the computer's memory.  The boot
  44. buffer is at address 2816 ($0b00) in bank 0.  To calculate the real start
  45. address of the ML code, add this number to the offset value.
  46.  
  47. 4) Boot message:  An optional message can be displayed when a boot is
  48. performed (BOOT xxxx ...).  Often, the name of the program to be booted is
  49. displayed, but the message may contain just about anything.  The message may
  50. contain control codes which are displayed as RVS characters by the boot
  51. sector analyzer.
  52.  
  53. 5) Command line:  Unlike the other information on the analyzer screen, this
  54. is not a feature inherent to C128 boot sectors. DISKSERVANT's Autoboot Tool
  55. contains a provision for creating a command line of your own fancy.  Since
  56. this is the kind of boot sectors you are probably most often going to create
  57. yourself, the BASIC command line (if found) is included here.
  58.  
  59. Hit any key to return to the Autoboot Tool menu.
  60.  
  61. DUMP SECTOR:
  62. Displays the contents of track 1 sector 0 as ASCII characters, regardless if
  63. it contains a boot sector or not.  Control characters are displayed as RVS
  64. codes.  A boot sector has the letters "cbm" as the three first characters.
  65. The Dump feature might be useful for revealing things about a boot sector
  66. that would otherwise be difficult to disclose.  Also, if the boot sector is
  67. blocked by a program, you might be able to identify the program which causes
  68. the interference.
  69.  
  70. Hit any key to return to the Autoboot Tool menu.
  71.  
  72. MAKE BOOT SECTOR:
  73. The objective here is to create a direct mode BASIC program line to be
  74. executed upon booting.  All immediate mode BASIC commands can be used, and
  75. the possibilities are limited by imagination and the size of the boot
  76. sector.
  77.  
  78. When you select Create from the Autoboot Tool menu, you're warned if a boot
  79. sector is already present on the disk, or if the boot sector is taken by a
  80. program or other data.  If you wish to preserve an original boot sector, you
  81. should use the Boot T3o File feature first.
  82.  
  83. Entering the boot message:
  84. Optionally, you can enter a message to be displayed upon boot (BOOTING xxxx
  85. ...).  There are a total of 239 characters available for the boot message
  86. and command line.  Every character of the boot message steals space from the
  87. command line.  Just press RETURN without entering anything if you don't want
  88. a boot message.
  89.  
  90. Please note that you are not limited to plain text; control characters may
  91. also be used.  Please refer to the section about RVS codes below for an
  92. overview of the control characters and how they are entered.  Also note that
  93. your computer in most cases will be in uppercase/graphics mode (alias
  94. "cursor up" mode) when the boot message is displayed.  Text entered as
  95. lowercase will appear as uppercase, and uppercase characters will appear as
  96. graphic symbols.  You may circumvent this by entering a RVS n (hold down
  97. CONTROL and press the n key) as the first character.  This will put the
  98. computer into lowercase mode (also called "cursor down" mode) when the boot
  99. sector is executed.
  100.  
  101. IMPORTANT:  NEVER use a RVS @ in your boot sectors.  A RVS @ will yield an
  102. ASCII code of zero which will effectively end the string or command line.
  103. Malfunction will be inevitable.
  104.  
  105. Entering the command line:
  106. This is just like entering a command line in the BASIC immediate mode.
  107. Several commands can be used, separated by colons.  Loops can be constructed
  108. using FOR-NEXT or DO-LOOP/EXIT.  Decisions can me made using IF/THEN/ELSE.
  109. Please note that you are not restricted to the 160 character limit allowed
  110. by the BASIC screen editor.  You can use up to 239 characters, minus the
  111. length of the boot message (if any).  You may use abbreviated BASIC commands
  112. if necessary.  Of course, the BASIC commands you are going to use most often
  113. are BOOT "filename", BLOAD "filename", SYS and RUN "filename".
  114.  
  115. It is important to use good sense when constructing a command line.
  116. Remember that you are limited to BASIC commands legal in immediate mode.
  117. This means that INPUT, INPUT#, GET and GET# are out.  READ/DATA, GOTO and
  118. GOSUB won't work because the command line doesn't contain line numbers.
  119.  
  120. Also be careful when using IF-THEN.  The command line after the THEN
  121. statement will be executed ONLY if the criteria set in the IF statement is
  122. true.  On the other hand, any commands following a ELSE statement will be
  123. executed ONLY of the conditions in the IF statement is FALSE.  This means
  124. that if several commands are to be executed in either case after an IF-
  125. THEN command, they must all be included twice; once after the THEN command,
  126. and once after the ELSE command.
  127.  
  128. Control codes (RVS characters) may be entered as part of the command line,
  129. but only inside quotes.  Control characters outside quotes will invoke a
  130. SYNTAX ERROR.   You may notice that typing a quote character won't invoke
  131. "quote mode".  Rather, if you want to include cursor control, insert,
  132. delete, home, clear or return codes, hold down ALT and press the appropriate
  133. key.
  134.  
  135. You may find it very useful to be able to boot a program from any disk
  136. drive.  For example, running a BASIC program from any disk drive is done
  137. like this:
  138.  
  139. run "program",u(peek(186))
  140.  
  141. Please note the use of parentheses.  The PEEK command must be enclosed in
  142. parentheses for the U specifier to work.  Please note that many programs are
  143. poorly programmed and might not be able to run off any other disk drive than
  144. device 8.
  145.  
  146. EDIT COMMAND LINE:
  147. You may want to edit a command line boot sector for debugging purposes or
  148. other reasons.  The boot sector is read off the disk and a check is made to
  149. establish if a valid boot sector really exists and that it contains a
  150. command line.  If everything is found to be OK, editing the command line is
  151. just like creating it for the first time.  Please refer to the section about
  152. creation of a boot sector above.  The boot message cannot be edited.
  153.  
  154. RUN/64 BOOT SECTOR:
  155. This selection will create a boot sector to lo